home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 028a / cvt_101.zip / CVT-101.DOC next >
Text File  |  1989-10-29  |  16KB  |  416 lines
  1.  
  2.                                 CVT-101
  3.  
  4.                           Copyright (C) 1989
  5.  
  6.                           Kenneth H. Starling
  7.                           Post Office Box 9096
  8.                     Salt Lake City, Utah 84109-0096
  9.  
  10.                               Version 1.01
  11.                             October 29, 1989
  12.  
  13.                       ┌──────────────────────────┐
  14.                       │ $10 LICENSE FEE REQUIRED │
  15.                       └──────────────────────────┘
  16.  
  17.  
  18.  
  19.   PROGRAM OVERVIEW
  20.   ────────────────
  21.  
  22.         The CVT-101 program files operate from the command line.
  23.         With them, you will be able to quickly and easily convert  
  24.         to and from nearly every type of archive compression. 
  25.         There are extra features, in addition to the speed and ease 
  26.         of use, which make CVT-101 the optimum choice for archive 
  27.         file conversion. 
  28.  
  29.  
  30.   FILES IN THIS ARCHIVE
  31.   ─────────────────────
  32.  
  33.         CVT.COM         The front end driver
  34.         CVT!.COM        The compress/decompress routines
  35.         CVT!!.BAT       A batch file you can customize
  36.         CVT-101.DOC     This documentation file
  37.         README.COM      Quick start instructions
  38.  
  39.  
  40.   QUICK START
  41.   ───────────
  42.  
  43.         Execute README.COM, and it will show you how to setup 
  44.         CVT-101 for a quick test.
  45.  
  46.  
  47.   PROGRAM FEATURES
  48.   ────────────────
  49.  
  50.         ∙ Low $10.00 license fee.
  51.  
  52.         ∙ Complete program included, not crippled or just a demo.
  53.  
  54.         ∙ CVT.COM will make the following conversions:
  55.  
  56.                 ∙ Every archive in the current directory,          
  57.                   regardless of the archive type.
  58.  
  59.                 ∙ Any specified archive in the current directory.
  60.  
  61.                 ∙ Any group of files in the current directory
  62.                   using any of the following parameters:
  63.  
  64.                           ????????.*
  65.                                  *.*
  66.                           ????????.[standard archive extension]
  67.                                  *.[standard archive extension]
  68.  
  69.         ∙ CVT.COM will convert the following formats (provided that 
  70.           the appropriate compress/decompress programs are located 
  71.           in a path subdirectory): 
  72.  
  73.                   From:    .ARC        To:    .ARC
  74.                   ────-    .DWC        ───    .DWC
  75.                            .CPR               .LZH
  76.                            .ICE               .LZS
  77.                            .LBR               .MD
  78.                            .LZH               .PAK
  79.                            .LZS               .ZIP
  80.                            .MD                .ZOO
  81.                            .PAK
  82.                            .SQZ
  83.                            .ZIP
  84.                            .ZOO
  85.  
  86.                            .?Q? when * is specified as the
  87.                                 filename extension. 
  88.  
  89.         ∙ Automatically recompresses nested archives (archives 
  90.           within an archive).  Will even recompress archives of 
  91.           different types within another archive type.  All nested 
  92.           archives are automatically converted to the new format.
  93.  
  94.         ∙ Automatically erases the old archive type.  The old 
  95.           archive is not erased until the new one has been made.  
  96.           This is an added safety feature in case of computer power 
  97.           loss. 
  98.  
  99.         ∙ Any defective archive is automatically moved to special
  100.           subdirectory called "BAD.$$$" created in the event of any
  101.           error in decompression.
  102.  
  103.         ∙ A file called "CVT-ERR.LOG" will be created in the
  104.           "BAD.$$$" subdirectory.  It will contain a record the
  105.           nature of any error.
  106.  
  107.         ∙ By switch selection, CVT!.COM will automatically invoke
  108.           McAfee Associates' virus scan program for a virus check
  109.           of all decompressed files.  In the event that an infected
  110.           file is found, the original archive is automatically 
  111.           moved to the "BAD.$$$" subdirectory, and the event is 
  112.           recorded in "CVT-ERR.LOG".
  113.  
  114.         ∙ Between decompression and recompression, CVT!.COM calls 
  115.           the batch file CVT!!.BAT.  With it, you can program your
  116.           own subroutines using the DOS BATch commands. 
  117.  
  118.         ∙ Extensive error handling features include:
  119.  
  120.                 ∙ Defective or incomplete decompressions.    
  121.                 ∙ Incorrect input specifications.
  122.                 ∙ Missing archival compress/decompress programs.
  123.  
  124.         ∙ Any .ZIP files which are converted will automatically 
  125.           drop any zipfile comment through the recompression 
  126.           process.
  127.  
  128.         ∙ Archives converted to .ZIP are compressed with the maximum
  129.           compression value.
  130.  
  131.         ∙ Screen colors can easily be changed with an hex editor.
  132.  
  133.         ∙ Converts .ICE files created by the hacked version of LHARC
  134.           distributed under the name of Lharc v1.14 or LHZ114.
  135.  
  136.  
  137.   HISTORY
  138.   ───────
  139.  
  140.         Vers. 1.00  -  Original release 10/27/89
  141.  
  142.         Vers. 1.01  -  Fixed bug that caused an incorrect error
  143.                        message and the program to lockup when the 
  144.                        archive decompressed a file without a    
  145.                        filename extension.  Added /s switch to
  146.                        initiate virus search subroutine, improved
  147.                        error handling, error messages, added an
  148.                        error log, and added additional color.
  149.  
  150.  
  151.   PROGRAM REQUIREMENTS
  152.   ────────────────────
  153.  
  154.         ∙ Requires MS-DOS or PC-DOS Version 2.0 or higher.
  155.  
  156.         ∙ Requires installation of an ANSI device driver.    
  157.  
  158.         ∙ Requires the following archival programs in order to
  159.           compress/decompress the archives:
  160.  
  161.                 .ARC  -  ARC.EXE (any version)        
  162.                 .CPR  -  FILETORP.EXE (any version)
  163.                 .DWC  -  DWC.EXE (any version)
  164.                 .LBR  -  LUE.EXE (Version 2.20)                
  165.                 .LZH  -  LHARC.EXE (any version)
  166.                 .LZS  -  LARC.EXE (any version)
  167.                          LARC7E.OVR (configuration file)
  168.                 .MD   -  MDCD.EXE (any version)
  169.                 .PAK  -  PAK.EXE (any version)
  170.                 .SQZ  -  ALUSQ.EXE (Version 1.1)
  171.                          (This version will process any ?Q?)
  172.                 .ZIP  -  PKUNZIP.EXE (any version)
  173.                          PKZIP.EXE (any version)
  174.                 .ZOO  -  ZOO.EXE (any version)
  175.  
  176.         ∙ Requires McAfee Associates' SCAN.EXE program to search
  177.           for virus infected files.
  178.  
  179.  
  180.   INSTALLING CVT-101
  181.   ──────────────────
  182.  
  183.         1)  Create a subdirectory for all of the archival 
  184.             compress/decompress programs that you intend to use,   
  185.             and copy them into it.  (If you already have a
  186.             subdirectory with them in it, there is no need to 
  187.             change it unless you want to do so). 
  188.  
  189.         2)  Copy the following files into the same subdirectory  
  190.             that contains the archival compress/decompress
  191.             programs. 
  192.  
  193.                 CVT.COM,  CVT!.COM,  CVT!!.BAT
  194.  
  195.         3)  Set the PATH to include the subdirectory that contains
  196.             the archival compress/decompress programs and the
  197.             CVT-101 programs. 
  198.  
  199.                 Example:  SET PATH=C;\;C:\DOS;C:\ARCHIVES
  200.  
  201.             It is recommended that you set the PATH during the boot 
  202.             process by inserting the command line into your  
  203.             AUTOEXEC.BAT file.
  204.  
  205.         4)  Install an ANSI device driver (this program uses
  206.             various ESCape codes).  If you have a color monitor, 
  207.             you probably already have such a device driver 
  208.             installed.  Monochrome users must also install such a 
  209.             device driver through a line in your CONFIG.SYS file in 
  210.             order for CVT-101 to work properly.  
  211.  
  212.                 Example:  DEVICE=C:\DOS\ANSI.SYS
  213.  
  214.             Any ANSI device driver such as FANSI.SYS, NANSI.SYS,   
  215.             etc. will work just fine.
  216.  
  217.         5)  If you intend to search the files for viruses using the 
  218.             "/s" option, SCAN.EXE must be located in any 
  219.             subdirectory which is included in your PATH.
  220.  
  221.  
  222.   RUNNING CVT-101
  223.   ───────────────
  224.  
  225.         CVT-101 is probably the easiest conversion program to use: 
  226.  
  227.                 CVT [filename] [new archive EXTension] /s
  228.  
  229.         That's all you do ─ the rest is automatic!
  230.  
  231.         Caution!   As an extra precaution, make sure that you have
  232.         ────────   backup copies of any archives running CVT.COM.
  233.  
  234.  
  235.   MODIFYING CVT-101
  236.   ─────────────────
  237.  
  238.         Because CVT!.COM automatically accesses CVT!!.BAT during 
  239.         its execution, it becomes possible for you to write you own 
  240.         BATch routines to be executed while the archive is 
  241.         decompressed and before the archived files are
  242.         recompressed.  The following are some suggestions of how 
  243.         you can get the maximum benefit out of CVT-101 by adding a 
  244.         few simple lines to CVT!!.BAT 
  245.  
  246.                 ∙ You can automatically remove unwanted files, such 
  247.                   as ads for bulletins boards, etc.   
  248.    
  249.                        Example:  if exist stupid.ad del stupid.ad
  250.  
  251.                 ∙ When you want to add some kind of file to each   
  252.                   archive (such as a special graphics ad for your
  253.                   BBS), you can use something like: 
  254.  
  255.                        Example:  copy c:\dos\my.ad 
  256.  
  257.                 ∙ When an archive contains files with a READ ONLY
  258.                   attribute, such files remain in the temporary
  259.                   subdirectory created by CVT!.COM.  When that
  260.                   happens, all subsequent archive conversions will 
  261.                   pickup that same file.  Additionally, CVT-101 and 
  262.                   most other conversion programs do not terminate  
  263.                   properly when READ ONLY files are contained in
  264.                   an archive.  Using the DOS ATTRIB.COM or Charles
  265.                   Petzold's ATTR.COM, you can automatically change
  266.                   any file attributes.
  267.  
  268.                        Example:  attr -r *.*
  269.  
  270.                 ∙ You want to alphabetize the files inside the 
  271.                   archive by their extension.  Using Peter Norton's 
  272.                   directory sort program, you add the following:
  273.  
  274.                        Example:  ds en *.*
  275.  
  276.                 ∙ You want to change all of the file times of the 
  277.                   files inside the archive.  Using Peter Norton's 
  278.                   file date program, you add the following: 
  279.  
  280.                        Example:  fd *.* /t12:01
  281.  
  282.         You are limited only by your own creativity.  By the way, if
  283.         you don't want your CVT!!.BAT subroutines displayed on the 
  284.         screen, most programs will permit you to add " > nul" after
  285.         the command line instruction.  Doing so will cause the
  286.         screen writes to be bypassed.  Try it first with each    
  287.         subroutine command as a test before adding it to CVT!!.BAT.
  288.  
  289.  
  290.   CHANGING THE SCREEN COLORS
  291.   ──────────────────────────
  292.  
  293.         With any hex editor, find the end of either the CVT.COM or 
  294.         CVT!.COM file.  Change the ANSI ESCape code sequence you will
  295.         find in the ascii window to the color of your choice. 
  296.  
  297.                        Example:  \#[1;37m  (bright white)
  298.                                 
  299.                                  Change to \#[1;33m (yellow)
  300.  
  301.  
  302.   CUSTOM VERSIONS
  303.   ───────────────
  304.  
  305.         I will be happy to prepare a customized version of the
  306.         CVT-101 program files with different color screens, or with 
  307.         the ability to do special subroutines, or other changes.  The
  308.         The minimum charge (also usually the maximum) is $49.00.
  309.         Send your requirements along with your telephone number and
  310.         check to me at the address listed at the end of this file.
  311.  
  312.  
  313.   TRADEMARKS AND COPYRIGHTS
  314.   ─────────────────────────
  315.  
  316.         ALUSQ Copyright (C) 1985 Alan Losoff                       
  317.         ARC Copyright (C) 1985-1989 System Enhancement Associates, Inc.
  318.         ATTR (C) 1986 Ziff-Davis Publishing Co. by Charles Petzold
  319.         DS Copyright (C) 1987-1989 Peter Norton Computing, Inc. 
  320.         DWC Copyright (C) 1986,1987,1989 Dean W. Cooper 
  321.         FD Copyright (C) 1987-1988 Peter Norton Computing, Inc.
  322.         CVT Copyright (C) 1989 Kenneth H. Starling 
  323.         CVT! Copyright (C) 1989 Kenneth H. Starling 
  324.         CVT!! Copyright (C) 1989 Kenneth H. Starling 
  325.         FILETORP Copyright (C) 1988 THC Communications Group, Inc.
  326.         IBM is the registered trademark of IBM Corporation 
  327.         LARC Copyright (C) 1988,89 Kazuhiko Miki
  328.         LHARC Copyright (C) 1988,1989 Haruyasu Yoshizaki 
  329.         LUE Copyright (C) 1984-1986 Vernon D. Buerg
  330.         MDCD Copyright (C) 1988 Mike Davenport
  331.         MS-DOS is the registered trademark of Microsoft Corporation
  332.         PAK Copyright (C) 1988,1989 NoGate Consulting
  333.         PC-DOS is the registered trademark of IBM Corporation
  334.         PKUNZIP (tm) Copyright (C) 1989 PKWARE, Inc. 
  335.         PKZIP (tm) Copyright (C) 1989 PKWARE, Inc. 
  336.         SCAN (C) 1989 McAfee Associates       
  337.         ZOO Copyright (C) 1988 Rahul Dhesi
  338.  
  339.  
  340.   DISCLAIMER
  341.   ──────────
  342.  
  343.         These programs are provided "as is" without any warranty of 
  344.         any kind, either expressed or implied, including, but not 
  345.         limited to the implied warranties of merchantability and 
  346.         fitness for a particular purpose.  The entire risk as to
  347.         the quality and performance of the programs is with you.  
  348.         You, the user, assume full responsibility for the results 
  349.         of the use of these programs, including, but not limited to 
  350.         the loss or corruption of data, or damage to any equipment.  
  351.         By your use of these programs, you agree to hold harmless  
  352.         all parties connected with the manufacture and distribution 
  353.         of these programs from any any liability whatsoever. 
  354.  
  355.  
  356.   DISTRIBUTION 
  357.   ────────────
  358.  
  359.         These files may be freely distributed, provided however, 
  360.         that any such distribution be made under the archival 
  361.         filename CVT-101.  Such distribution must include all of 
  362.         the files itemized under "FILES IN THIS ARCHIVE" herein. 
  363.         These files may NOT be distributed as the part of any other 
  364.         program or under any other name whatsoever. 
  365.  
  366.  
  367.   BUGS
  368.   ────
  369.  
  370.         I've done everything I can imagine to test for bugs  If you 
  371.         you encounter any bugs, I would like to know about them.  My 
  372.         name, address and a bulletin board contact may be found at
  373.         the end of this file.   
  374.  
  375.  
  376.   BULLETIN BOARD CONTACT
  377.   ────────────────────── 
  378.  
  379.         Redundant Department  (801) 272-7057                    
  380.  
  381.                               PC Pursuitable via UTSLC
  382.  
  383.  
  384.   CONDITIONS OF USE
  385.   ─────────────────
  386.  
  387.        Corporate site licenses are required for corporate, agency 
  388.        and organizational use.  Contact me at the address that 
  389.        follows for site license information.
  390.  
  391.        You may examine, modify and use CVT.COM, CVT!.COM and 
  392.        CVT!!.BAT free of charge for ten days.  Thereafter, if you 
  393.        use any of them, either in their present form or any other 
  394.        form, you are required to pay the $10.00 user fee. 
  395.  
  396.        Upon payment of the $10.00 user fee, you are granted a non 
  397.        exclusive license to use and modify any of the files for 
  398.        your personal use only.
  399.  
  400.  
  401.  
  402.        Send user fees to:   Kenneth H. Starling
  403.        ─────────────────-   Post Office Box 9096
  404.                             Salt Lake City, Utah 84109-0096
  405.  
  406.                                  CVT-101 . . . . . . $10.00             
  407.  
  408.  
  409.           ┌─────────────────────────────────────────────────────┐
  410.           │ At $10.00 these programs are an incredible bargain, │
  411.           │ so how about dropping a ten in the mail?            │
  412.           └─────────────────────────────────────────────────────┘ 
  413.  
  414.  
  415.                                                               <eof>
  416.